home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
qrfm41.zip
/
QRFM.DOC
< prev
next >
Wrap
Text File
|
1992-12-03
|
54KB
|
992 lines
QRFM Ver 4.1 4 Dec 92
Mountain Retreat Software
QRFM
(c) Copyright 1991 by John Jamieson
All Rights Reserved
Intro:
QRFM is a BBS File Manager, you should be able to handle all your
BBS file management chores from this platform. QRFM is designed
especially for the BBS with Limited Hard Disk space and without a
Backup Tape Drive. I think a lot of us have Boards that fit this
description. QRFM uses a data base to manage online files in the
Upload and DownLoad directories and offline files residing on
floppies. This system makes it possible to run a BBS with a large
complement of offline files. Offline files are easely placed back on
line, QRFM tells you what floppy disk it needs in order to return
a file to a download directory.
Although QRFM was designed with QuickBBS Vers 2.75 and Remote Access
Vers 1.10/1.11 in mind. It should be useable with any BBS that creates
DoorInfo1.BBS and uses Files.BBS to record file descriptions.
QRFM now swaps to EMS if available or Disk if EMS is not available
when either shelling to DOS or when shelling to other programs.
Because of QRFM's memory needs amd because QRFM shells to programs
like ARJ which requires 290k plus memory, it was a problem assuring
adaquate memory. With Swaping, QRFM no longer places such heavy
demands on memory.
Qrfm Features:
a) Move files from the Upload area to a DownLoad area, between
DownLoad areas and between Download areas and BackUp flopies.
b) Edit File Description, Name or Date. The description editor
allows the use of 240 character descriptions.
c) Check/View/Alter the contents of an Archive,
(Shells to your Archive programs then your File Manager)
d) Recompress File to different Compression type,
(Shells to your Archive programs).
e) Check for Virus, (shells to your virus checker).
f) Backup Files to Floppy and Catalog those backups.
Files are backed up and the backups cataloged, makeing it
possible to take files offline and put them back on line
easily. Backup file copies are kept in groups in accordance
with assigments made when configuring file areas. Each download
area can be assigned a backup group or a group of download
areas can use the same backup group.
g) Delete unwanted files both online and backup copies.
h) Search for files by File Name or Key Word.
i) Produces a variety of file lists, including
.Cross Reference file lists in both .Ans and .Asc
format for display with Type 45 menu item.
.AllFile listings for a specified user level.
.File lists of selected file areas.
j) Pick List access to file information. Display includes Backup
disk number, name of Uploader, and the number of downloads as
well as description, size and date.
k) CDROM compatable
SrchDoor Features:
a) Uses the Qrfm database to perform fast searches. Handy if File
Lists have gotten so large that the BBS searches are time consuming.
SrchDoor uses the QRFM indexs in New file and File Name searches.
b) Searches can be performed on all areas or they can be limited to
a collection of areas or one area.
Operation Overview:
The Setup functions provide the system with the information that it
requires to operate.
To exit the program Close any window that might be open by pressing
the F10 key or by clicking on the [■] in upper left corner of the
window. then press Alt-x. You could also exit, selecting eXit on the
Exit SubMenu.
PickLists are used to select files to be operated on by the File_Ops and
Offline_Ops menus. A the way it works is a file is selected from the
Pick List, use the Mouse or Arrow keys to make a selection. A High
Lighted file is a selected file, then without exiting the PickList window
select the File_Ops or Offline_ops menu and select the required operation.
The Pick_Lists menu offers 3 Lists the Upload, DownLoad and Not Backed up
Lists and in addition the menu has a function to Load New Uploads into
the data base. The Load New Uploads Function loads info on files not
previously loaded into the data base for use by the UpLoad PickList.
File Ops menu is broken into two areas. The first contains functions
that operate on a file selected using one of the pick lists. The
second group of functions operate on files extracted from the
selected file and placed in the QRFM\Temp directory. The extracted
contents of an archive can be altered using a file manager, the files
can then be recompressed. Use this method to alter the contents of
Files, as any changes to a file's, date, size, or name will cause
conflicts with the data base, if changes are made to a file outside
the QRFM system.
Whenever you highlite a file then press enter to shell to your file
manager, if the file hasn't already been decompressed to the TEMP
directory, the first thing QRFM does is decompress the file. The file
is also decompressed when any of the File Ops functions below the
line are chosen.
The Offline Ops menu provides the tools for maintaining offline files.
The Locator menu contains the search functions.
The BBS Lists menu can Update the Files.BBS lists, Prepare an
AllFiles List and Reference Area Lists. But it's a good idea to set
up a maintenance event using the utility QRFMFLST.EXE to accomplish
the task. QRFMFLST.EXE will also handle the task of importing of
uploads. The AllFiles.Lst file and the cross Reference Area lists are
placed in the QRFM directory. When you make File Lists available for
download, use a directory that has not been entered in the QRFM
configuration. Since file lists are continually changing size it
would be a make work project trying to keep the QRFM data base up
to date. I have a seperate download directory for file lists and
offer a selection of different file lists.
General Info:
The Files.BBS files in both the Upload and Download file areas are
updated only when the BBS_Lists function [Update Files.BBS] is
selected or the utility QRFMLST.EXE is used to accomplish the update.
Prior to running [Update Files.BBS] Qrfm input is only recorded in
the QRFM data base.
A Files.BBS must exist in every non CDROM area. Because in order to
support CDROM's, if QRFM dosen't find a Files.BBS file in the File
Area Directory it will assume that the area is a CDROM area and
description changes will be written to a FilesXX.BBS file in the
QRFM\Lists directory (the File Area Code will be used in place of XX
in FilesXX.BBS). If for any reason the Files.BBS dosen't exist put a
dummy Files.BBS in that area so QRFM can replace it with an updated
one or move and rename the FilesXX.BBS, after it has been created)
from the lists directory to the File Area Directory.
If you choose to use QRFM, all changes to the Files.BBS files and
files in the associated directories should be accomplished using QRFM
and it's utilities. Bypassing QRFM to make changes will leave the
data base out of sync. Most functions are handled from the QRFM
menus, but in some unusual cases you may have to be creative. Lets
say you want to add a readme file to a .ZIP file in one of the
download file areas. First highlite the file that will be added to
then press enter to decompress it. Then drop to DOS and add the
readme file to the decompressed package in the QRFM\TEMP directory.
Return to the program and recompress the file.
To add files to the system it's best to just place them in the
Uploads directory and import them as with Uploads. Descriptions
can either be added using the QRFM editor or the Files.BBS could
be edited to pickup the new description. If the files were added
to a download directory you would have to run the QRFM utility
VerifDb to add the file to the QRFM database. This last approach
could be slow if VerifDb is working with a large data base.
The importing of new files from the uploads directory into the QRFM
data base can be done automaticly using the utility QRFMFLST.EXE
during a system event or it can be accomplished from the Pick List
Menu item [Load New Uploads].
QRFM does not allow duplicate file names even if the files have a
different extension or are in a different directory. The uploads
directory will take the file but the name must be changed before
before the file can be moved to a download directory.
QRFM can be used with or without a mouse. If running without a mouse
use the arrows keys to select menu items and the Tab key to Select
Entry fields or Selections. Main menu items are selected by pressing
the Alt key plus the HighLighted letter in the menu item description.
See KeyPress info below.
Importing my Files.BBS and associated file info, 3,600 files, into
the QRFM data base took 4.5 hours on my 386SX, allow plenty of time
for this function.
An associated Door, SRCHDOOR, Makes use of the QRFM data base to
provide improved search capability. SrchDoor does a very fast New
Files search or File Name search. In addition it will search all
lines in multi line descriptions.
QRFM includes a File Cross Reference capability. A usage for
instance: Include all files including Pascal source code in a cross
list or include all files supporting VGA in a cross reference list.
Cross Reference Areas are created with Config menu item (File Areas).
Files can be taged for inclusion in up to 5 cross reference areas
using the File_Ops menu item (Add to Ref Area).
When using the File Manager function, changes can be made to the
contents of a file. The File Manager works with files decompressed or
moved into the temp dir. If any changes are made to this decompressed
package, the Recompress function must be used to replace the
origional copy of the file.
QRFM uses a database to manage Quickbbs/RA files. The location of
files on backup disks cannot be recontructed. For this reason it is
recommended that .DAT and .CFG files be backed up at least after
every session involving the backup of BBS down loadable files, or the
deletion of a file involving a floppy.
Setup:
a. Create a QRFM directory, a LISTS Subdirectory and a TEMP
Subdirectory and place QRFM.EXE and the utilities you intend to
use in the QRFM directory.
C:\─┐
│
└─QRFM────────────┬─QRFM.EXE
├─SRCHDOOR.EXE or SRCHDOR2.EXE
├─QRFMSRCH.EXE
├─QRFMFLST.EXE
├─CNTDN.EXE
├─UPBY.EXE
├─VERIFDB.EXE
├─REBLDIDX.EXE
├─QRFM.KEY
│
├─TEMP (SubDir)
└─LISTS (SubDir)──── *.HDR
When you run QRFM for the first time the following files are
created in the QRFM directory.
│
├─QRFM.CFG
├─QRFMAREA.DAT
├─QRFMDESC.DAT
├─QRFMFILE.DAT
├─QRFMAREA.IDX
├─QRFMDATE.IDX
├─QRFMNBAK.IDX
└─UPLFILE.IDX
The rest of the setup is handled from the Config menu.
┌────────────────────────────────────────────────────────────────────┐
│Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config │
└───────────────────────────────────────────────────────────────┬────┘
│
┌──────────┴───────────┐
│ Directories │
│ File Areas │
│ Compression Methods │
│ Other Externals │
│ Import Files.BBSs │
│ Backup Drive │
├──────────────────────┤
│ Import all Files.BBSs│
│ Import a files.BBSs │
└──────────────────────┘
b. The BBS Upload and DnLoad directories should contain the
Files.BBS and the files listed in the Files.BBS. Any other
files in the BBS Upload and DnLoad directories that you
don't want to appear in the data base should be removed.
Prior to running Import Files.BBS. Files not listed in
the Files.BBS will be included in the data base with a
dummy description. Any files that get past you can be
deleted later.
c. Change to the QRFM dir and Run QRFM. Allow QRFM to build
the Config files. Then select Setup and then complete the
Setup items. The BBS as it exists at present should be
reflected in these entries.
1. Directories: Enter the complete path names for your BBS
Program directory and your DownLoad Directory.
╔═[■]═════════════════ System Directory Config ════════════════╗
║ ║
║ ║
║ BBS Directory c:\Ra ║
║ ║
║ Upload Directory D:\newfiles ║
║ ║
║ [ Ok ] [Cancel] ║
║ ║
╚══════════════════════════════════════════════════════════════╝
2. File Areas: Enter the complete path names for all of the
BBS File Download areas and File Cross Reference areas.
File Cross Reference Areas are explained in General Info
above.
All areas in use must be entered at this time. The Areas
ConFig window operates as follows.
The window opens in the [Add Area] configuration use the
mouse or Tab key to select the Area key field. Enter a
two character Area Key for a download area. This key will
be used by the system in all future record keeping. Use
the Mouse,Alt+ HighLighted Letter or Tab key to move to the
other entry fields and complete them. DON'T use the enter
key when entering Data it will switch you to [Pick Area].
When all the fields are complete, Select [Save].
The selection boxes have these functions.
[Add Area] formats entry fields for a new area.
[Add XRef Area] formats fields for a new cross reference area.
[Pick Area] will allow you to select an area from those
assigned, in order to make changes.
[Save] saves the current entry
[Delete] deletes an unused area.
[Done] or [Cancel] Exits the window, a click on the [■] in
upper left corner, or pressing F10 will also exit the window.
╔═[■]═══════════════ Areas Config ════════════════════╗
║ 1A ░ ║
║ 1B ░ Area Key 1A ║
║ 1C ░ ║
║ 1D ░ Access Level 5 ║
║ 1E ░ ║
║ 1F ░ Description Menu Systems ║
║ 1G ░ ║
║ 1H ░ Area Path H:\Menu ║
║ 1I ░ ║
║ 1J ░ BackUp Group 00 to 99 02 ║
║ 2A ░ ║
║ 2B ░ [ Add Area ] [ Done ] ║
║ 2C ░ ║
║ 3A ░ [ Add Xref Area ] [Cancel] ║
║ 3D ░ ║
║ 3E ░ [Pick Area] [Save ] [Delete] ║
║ 3G ░ ║
╚═════════════════════════════════════════════════════╝
3. Compression Methods: The compression methods you deal with
should be entered here with the corresponding extraction and
compression commands. If the programs called here are not in
your path, use the full path names. If you use ARJ you will
need much memory, QRFM running ARJ seems to need about 500k.
The following example supports the inclusion of subdirectory
information in files. The Alternate Extraction Command allows
you to decompress without using path info. I found it necessary
to add this Alternate Extraction command because I was finding
some uploads that were compressed with path info in error. The
Alternate Extraction Command allows me to drop that path info
when decompressing by using Arj e.
╔═[■]════════════════════ Compression Methods ════════════════════╗
║ ║
║ Ext. Extraction Cmnd Compression Cmnd Alt Extract Cmnd ║
║ ║
║ ARJ Arj x -y Arj a -jt -y -r Arj e ║
║ ZIP PkUnZip -d PkZip -rp PkUnzip ║
║ PAK Pak e Pak a /I ║
║ SDN Pak e Pak a /I ║
║ ║
║ ║
║ [ Ok ] [ Cancel] ║
║ ║
╚═════════════════════════════════════════════════════════════════╝
4. Other External: Give the system the command that executes your
Directory manager and Virus checker. As with compression Methods
If the programs called here are not in your path, use the full
path names. The directory manager and Virus Scan programs
shown in the example below are Shareware programs selected for
the example because of their availability. They are found on
BBS's as DR.* And SCANV*.*. First give your favorite File
Manager and Virus checker a try. A couple of other file
managers I tried worked fine and can be substituted for DR.
DF.EXE, Directory Freedom on my BBS as DF450.ZIP or DB.EXE
from Director Vers 4.5 on my BBS as DIRECTOR.ZIP.
╔═[■]═══════════════ External Calls Config ════════════════════╗
║ ║
║ ║
║ Dir Manager DR ║
║ ║
║ ║
║ Virus Check B:\Scan\Scan /D *.* /NOMEM ║
║ ║
║ ║
║ [ Ok ] [ Cancel] ║
║ ║
╚══════════════════════════════════════════════════════════════╝
5. Select the drive that you wannt QRFM to use for floppy backups.
6. Import Files.BBS: when the rest of the setup is complete you
are ready for this function. All the Files.BBS files except
the one in your Upload directory are read in to the Data Base
along with File sizes and file dates. Orphan files are also
imported, and a list of any files that are called out in the
Files.BBS but not found in the Directory, is produced and
placed in the download directory. This function is intended to
be used only once. It can be repeated if for some reason files
have been added to the download directory without using QRFM.
If repeated this function only picks up files not already in
the Data Base. The reading of the Upload directory Files.BBS
is a seperate function and is found in the Pick_Lists Menu.
This function is not required if the BBS dosen't have files
yet. Already mentioned above but I will mention it again,
importing my Files.BBS and associated file info, 3,600 files,
into the QRFM data base took 4.5 hours on my 386SX, allow
plenty of time for this function. If you want you can import
directories one at a time using the Import a Files.BBS function.
Operation:
a. After the configuration has been established including the Import
of Download areas, Files.BBS, into the QRFM database, the system
is ready for use.
Any files that are in the upload directory should be imported at
this time. Use the Pick_List menu item [Load New Uploads], it
will import all files that haven't already been imported, into
the QRFM data base. A file does not have to be on the Files.BBS
list, Orphan files are also imported into the data base.
You can use this feature when adding files to the board. Just
place them in the Upload directory and import them, then use the
QRFM description edit function to add a description.
Descriptions read from the Upload Directory Files.BBS can be up
to 240 characters on the same line as the File name and starting
in column 14. When imported into the QRFM data base descriptions
are placed in lines 46 characters long. Only 7 lines can be
displayed by QRFM and only 240 character descriptions can be be
edited. Keep descriptions under 240 characters.
b. Pick_Lists are used to select a file for processing by the the
functions in the File_Ops and OffLine_Ops menus. A file must be
high-lighted in a Pick_List before a file can be processed. Pull
up Pick_Lists by selecting one from the Pick_List menu with
mouse, function Key, or Alt key and menu item first letter. Close
a Pick_List with the F10 key or click on the upper left corner
with the mouse.
Key presses available while traversing the Pick_Lists:
Home HiLite Bar moves to first item
End HiLite Bar moves to last item
PageUp HiLite Bar moves up a page
PageDn HiLite Bar moves down a page
Up Arrow HiLite Bar moves up a line
Dn Arrow HiLite Bar moves down a line
Enter If a file is HiLited the file is uncompressed and
your file manager is called to view it's contents
If a file area is not displayed the HiLited file
area will be displayed.
Left Arrow If a file area is displayed it will be closed so
so that another area can be opened.
Any Character The file HiLite bar will jump to the next or first
File whos name starts with that character.
Space Bar Mark a collection of files for a group move. The
space bar can also unmark a marked file.
Tab When in window that has a number of buttons and
fields the Tab key can be used to the next button
or field.
The mouse can be use to select files, Menu items and buttons.
the Right mouse button when clicked on a file name functions as
the space bar and will mark that file for a group move.
c. File_Ops functions are all pretty much self explanatory. A couple
of things that arn't, when working with files you must first
bring up one of the three Pick Lists. With the UpLoad or DnLoad
Pick list displayed all the File_Ops are active.
Select a file by clicking on it with the left mouse button or
using the Arrow keys to move to and high-lite the file. Once a
file name has been high-lighted use the mouse or Alt-f to select
the File_Ops menu.
When moving files an optional tag and move is supported. If the
Move menu item is selected and any files are taged they will be
moved instead of the HiLited file. Files are taged by pressing
the right mouse button or the space bar.
If during the functions (Recompress, File Manager or Virus Scan)
a file is encountered that dosen't have a Extension, that can be
found in the Setup, the following steps are taken:
If the file is a .EXE you will be asked if you want to try and
decompress it. If you answer no or if the file has any other
extension that isn't found it will be copied to the Qrfm Temp
subdirectory. And the selected function will be completed.
The Lower Description Case function will change the description
from UpperCase to LowerCase with the exception of the first
character in each word.
d. OffLine_Ops are active when the DnLoad Pick list is being displayed.
In addition the OffLine_Opp menu items [Backup to Floppy] and
[Mark Backup N/R] are active when the NotBacked picklist is
displayed.
The menu item [Mark Backup N/R] will mark an item as not requiring
backup, an item so marked will not appear on the Not Backed pick
list.
If QRFM is told to backup a floppy you will be asked to place a
floppy in the A: drive. If room is available on an existing
backup disk, in the required backup group, that disk disk will be
requested otherwise a blank formated disk will be requested. Once
backed up a file can be taken offline and put back on line as
required. QRFM keeps track of offline status, floppy disk
numbers, and the space available on floppys. The maximum number
of files that QRFM can catalog on a floppy has been set at 21.
e. The Locator menu provides quick access to info in the data base.
The Pick_Lists can not be displayed when using Locator menu
functions.
f. The BBS_Lists menu has functions for updateing the BBS file
listings. The File lists are are not maintained during File_Ops
functions, and must be updated using the BBS_Lists functions or
using the QRFM utility QRFMFLst (see info on utilities below).
The AllFiles.Lst, BakUpDsk.Lst and Reference Area lists are
placed in the QRFM\LISTS subdirectory. The Function (Get XferDoor
DnLoad Counts) will only function if XferDoor is used for
downloads. It incorporates downloads made using XferDoor into the
QRFM Data Base. See the paragraph on XferDoor below. Reference
area lists are created in .ANS and .ASC format for display by the
BBS.
g. The QRFM menu system
┌─────────────────────────────────────────────────────────────────────┐
│ Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config │
└────────┬───────────────┬────────────┬───────┬─────────┬─────────────┘
│ │ │ │ └─────────┐
┌────────┴─────────────┐ │ │ ┌────┴─────────────────┐ │
│ UpLoad File List F2 │ │ │ │ Filename Search │ │
│ DnLoad File Lists F6 │ │ │ │ Keyword Search │ │
│ NotBacked Up List │ │ │ │ Backup Disk Contents │ │
├──────────────────────┤ │ │ └──────────────────────┘ │
│ Load new Uploads │ │ │ │
└──────────────────────┘ │ │ │
┌────────────────────────┴┐ ┌────────┴───────────┐ │
│ Move F5 │ │ Backup to Floppy F7│ │
│ Edit Description │ │ Delete Backup Copy │ │
│ Name Change │ │ Take Offline │ │
│ Date Change │ │ Put Back Online │ │
│ Kill File │ │ Mark Backup N/R │ │
│ Add to Ref List │ └────────────────────┘ │
│ Cut from Ref List │ ┌────────────────────────┴───┐
│ Lower Description Case │ │ UpLoad Files.BBS Update │
│ UpLoaded By Name Edit │ │ DnLoad Files.BBS Update │
├─────────────────────────┤ │ Write AllFiles List │
│ Recompress F4 │ │ Reference Area Lists │
│ Search for Virus │ │ Backup Disk File List │
│ File Manager │ └────────────────────────────┘
│ Virus Chk/File Mgr F3 │
│ Alt eXtract │
└─────────────────────────┘
h. Example PickList with File File DTP256.ARJ selected from the
File Area 1G.
Exit Pick_Lists File_Ops Offline_Ops Locator BBS_Lists Config
╔═[■]══════════════════════════ DnLoad Selector ═══════════════════════════════╗
║ Area Graphics ║
║ ═╪══════════════════════════════════════════════════════════════════════ ║
║ 1A ░ DANFLIK2.ZIP ────────Area Info───────────────────────────────── ║
║ 1B ░ DANFLIK3.ZIP ░ Path: D:\_Graph ║
║ 1C ░ DAZE41.ZIP ░ Space Avail=219316224 ║
║ 1D ░ DAZZLE.ZIP ░ Area Access Level: 5 ║
║ 1E ░ DAZZLE12.ZIP ░ ────────File Info───────────────────────────────── ║
║ 1F ░ DBWRENDR.ZIP ░ #:49 Size:274918 Date:10/29/1991 ║
║ 1G══░ DIGPRNT.ZIP ░ XRef Areas: A Dnloads: 4 ║
║ 1H ░ DOSEYE.ZIP ░ Backup Group:06 ║
║ 1I ░ DRAFTC.ZIP ░ Uploaded By: Paul Jones ║
║ 1J ░ DTP16.ZIP ░ ────────File Description────────────────────────── ║
║ 1K ░══ DTP256.ARJ ═══░ DeskTop Paint 256. VGA Drivers for ATI, ║
║ 2A ░ DUMP0891.ARJ ░ Headland & Paradise cards. A full colour ║
║ 2B ░ E2VGA5.ZIP ░ bitmapped paint program uses the extended ║
║ 2C ░ EASYCASE.ZIP ░ resolution of super VGA. Full colour ║
║ 2D ░ EDRAW320.ZIP ░ manipulation and drawing, output in PCX, GIF, ║
║ 3A ░ EEDRAW.ARJ ░ IFF/LBM, TIFF formats. ║
║ 3B ░ EGA2VGA3.ZIP ░ ║
║ 3C ░ EGAGRAPH.ZIP ░ ║
║ 3D ░ EGALASER.ZIP ░ ║
╚══════════════════════════════════════════════════════════════════════════════╝
F2 Ups F3 Chk F4 Comp F5 Move F6 Dns F7 Bak F8 Info F9 DOS F10 Close
i. The status line offers a one key press short cut to some of the
more often used functions.
Recovery from a Hard Disk Crash:
Backup the QRFM .Cfg and .Dat files on a regular basis in
preparation for an eventual hard disk crash. As a minimum the .Dat
files should be backed up each day in which download area files have
been backed to floppy. If the QRFM backup dosen't reflect the
condition of the backups on floppy, there is no way for QRFM to
recover the location of those files. I guess I could write a utility
to verify that the data, on the backup flopies, is in the database.
I have over 600 flopies that verifying would be a bit much.
If a crash wipes out the QRFM directory/files restore them from
backup and run the utility ReBldIdx.EXE to generate the .Idx index
files, if they wern't included in the backup. If the QRFM
directories were lost be sure to re-create the QRFM sub directories.
Then restore any of the DownLoad/UpLoad directory structure that was
wiped out. Files.BBS are not needed QRFM will create them. QRFM
won't create missing directories, you must create them. (a possible
future QRFM revision). Missing files or files not recorded in the QRFM
backup, are not a problem. After the system again matches the QRFM
configuration data, run the utility VerifDb.Exe from the QRFM
directory.
VerifDb will check each file entry in the QRFM data base against the
actual files in the download directories and it will update the
files on line status. No need to place files that were lost in the
crash back on line prior to running VerifDB, all files backed up
using QRFM and not found on line will be statused as OffLine.
QRFM recorded files that were lost and had not been backed up will
be deleted from the QRFM data base and are reported in a file named
VerifDb.Log that will be placed in the QRFM directory. The QRFM
backup may be a bit out of date so the download directories will be
checked for files that arn't in the QRFM data base. Files found in
the download directories that are not recorded in the QRFM backup,
will be added to the QRFM data base with out a description and will
be reported in VerifDb.Log. The QRFM edit function can be used to
describe the file.
Systens that have a CDROM:
When importing files during QRFM setup if CDROM files.BBS's are to be
imported place files.BBS in the QRFM Lists directory under the name
FilesXX.BBS, one for each CDROM directory. Substitute the two
character QRFM file area designator for XX in the file name. If QRFM
dosn't find a Files.BBS in the File Area it will look in the Lists
directory. Description changes will be written to the FilesXX.BBS.
Utilities and related programs:
The following programs are not required in order to use QRFM, they
provide added features if you want or need them.
1. SrchDoor and Srchdor2
a. The difference between these two programs is that SrchDoor uses
Exitinfo.BBS and will give a user a list of new files since
the users last call. SrchDor2 uses DorInfo1.Def and does
everything else that SrchDoor does except for that one new files
function.
a. SrchDoor does fast file name and new file searches are valuable
when the BBS searches are being slowed down by a large file
collection. SrchDoor makes use of the QRFM database to provide
fast and complete NewFile and FileName searches. SrchDoor will
also do description word searches. Another use for SrchDoor is
to restrict searches to particular directories. SrchDoor looks
in the default directory for DorInfo1.Def, and uses the
environment variable QRFM=C:\QRFM to locate the QRFM files.
SrchDoor will only display areas that fall within the user
security level.
b. SrchDoor will run in stand alone local mode and as a door in
on-line door or in local mode. To run as a door SrchDoor must
find ExitInfo.BBS or DorInfo1.Def if you are running SrchDor2.
c. Two seperate Search menus can be called, a QuickBBS type 7 door
is recomended. The command line parameter "S" will cause
SrchDoor to use it's File Search Menu and the parameter "N" will
bring up the New Files Menu. Command line parameters can also be
included to spell out the file areas that are to be searched and
a parameter can be used to force SrchDoor to Monochrome on the
BBS monitor.
An example of how to call the door and samples of the menus
follow. Useing a QuickBBS type 7 menu Place the Full Path Name
followed by command line parameters in the Menu Optional Data
Field.
Example command lines for File Name and Key Word searching
to search all areas to search selected areas
C:\QRFM\SrchDoor.EXE S C:\QRFM\SrchDoor.EXE S TP TC TA
Example command lines for New Files searching
to search all areas to search selected areas
C:\QRFM\SrchDoor.EXE N C:\QRFM\SrchDoor.EXE N TP TC TA
The two character parameters in the examples to the right are
area codes identifying file areas that a search is to be limited
to.
SrchDoor can be forced to MonoChrome on the BBS monitor by
the use of a M parameter. Example: C:\QRFM\SrchDoor.EXE M S
If used M must be the first parameter.
╔════════════════════════════════════════════════════════════════════════╗
║ Search for a File ║
╠════════════════════════════════════════════════════════════════════════╣
║ 1 File Name Search ║
║ 2 Description Key Word Search ║
║ Q Exit New File Search ║
╠════════════════════════════════════════════════════════════════════════╣
║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║
╚════════════════════════════════════════════════════════════════════════╝
Input :
Item 1 in the following screen is not available in SrchDor2
╔════════════════════════════════════════════════════════════════════════╗
║ New File Search ║
╠════════════════════════════════════════════════════════════════════════╣
║ 1 New Files Since Last Date Called ║
║ 2 Files Added in the Past Week ║
║ 3 Files Added in the Past Month ║
║ 4 New Files as of mm-dd-yy ║
║ 5 New Files as of X Days ago ║
║ Q Exit New File Search ║
╠════════════════════════════════════════════════════════════════════════╣
║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║
╚════════════════════════════════════════════════════════════════════════╝
Input :
d. SrchDoor.EXE is included in the QRFM package. If a Fossil
version is required it can be downloaded or Freq'd from
Mountain Retreat BBS. FileName QRFM_FOS.ARJ.
e. Trouble shooting the SrchDoor installation:
The Status bar can be an aid in trouble shooting the door
installation. Check for a comment in the lower left corner
of the status bar.
2. QRFMSrch
QRFMSrch is a stand alone Search utility. It more or less duplicates
the features of SrchDoor. It only needs the QRFM data base to
function, it dosen't need access to the BBS and it's directories. If
not running QRFMSrch from the QRFM system directory , it is
necessary to add the environment variable SET QRFM=C:\QRFM, set it
to whatever directory QRFM is in.
3. QRFMFLst
QRFMFLst is a utility that can be run from a batch file. It will
accomplish the QRFM BBS List functions and then some. Command line
parameters are used to tell QRFMFLst the functions that are to be
accomplished. If not running QRFMFLst from the QRFM system
directory, it is necessary to add the environment variable SET
QRFM=C:\QRFM, set it to whatever directory QRFM is in.
If you use XferDoor then the -F option will obtain DownLoad Counts
and the name of the User that uploads a file from files created by
XferDoor.
If you don't use XferDoor then the -O option will accomplish the
same tasks as the -F option, obtaining Names and Download counts
from the UpLoads and DnLoads logs. This -O option puts a copy of the
last DnLoads.Log line read into a Textfile called LastDn.Log in the
QRFM directory. If that file is not found the complete DnLoads log
will be processed, so don't delete it unless you also delete the
DnLoads.Log. If you are switching from XferDoor to another Transfer
Door you will want to create LastDn.Log or start with a new DnLoads
Log so that Downloads already counted don't get counted again. This
-O option could be time consuming if the UpLoads and DnLoads Logs
are allowed to get very long.
QRFMFLst -O will accomplish the QRFM menu items
a. Load new Uploads
b. Get DnLoad counts from DnLoads
Log
c. UpLoad Files.BBS Update
e. DnLoad Files.BBS Update
** ATTENTION, Use this option
if you DON'T USE XferDoor to
handle file transfers and want
to use the DnLoads.Log to obtain
download counts. Use the -F
option if you use XferDoor.
QRFMFLst -F will accomplish the QRFM menu items
a. Load new Uploads
b. Get Xferdoor DnLoad counts if
available
c. UpLoad Files.BBS Update
e. DnLoad Files.BBS Update
** ATTENTION, Use this option
if you USE XferDoor to handle
file transfers
QRFMFLst -R will accomplish the QRFM menu item
Reference Area Lists, updating
all Reference Area lists.
Reference area lists are created
in .ANS and .ASC format for
display by the BBS.
QRFMFLst -L Level will Generate a Allfiles List
QRFMFLst -L 50
would Generate a Allfiles List
and include only areas with a
security level less than 50.
QRFMFLst -S Adult.Lst D G1 Will Generate a list of the files
in file areas D and G1 and place it
in the lists subdirectory under the
name Adult.Lst.
QRFMFLst -D Character Will Generate a files list for each
area with a name that is generated
as follows. Character+File Area
key+.DIR. You probably will have no
use for this one it was for a
special purpose.
The lists generated by the -S and -L switches can include a header
of your design. Create a list header and place it in a File with
the extension .HDR and same name as the file it is to be used with.
Place the file in the lists subdirectory and it will be included
when the file list is generated.
Command line parameters can be combined, but LIMIT the Length of the
parameter string to 100 characters.
Example: QRFMFLst -F -R -L 50 -S Adult.Lst D G1 -S Prog.Lst 1 2 3
I had some problems with very long command lines and as yet don't
know what QRFMFLst command line limits are. My longest command line
at this time is 70 characters. If length becomes a problem just don't
combine too many options.
4. XferDoor
XferDoor when used in conjunction with QRFM provides added features
in both QRFM and XferDoor. Qrfm will be given the name of a File
UpLoader and in addition DnLoad counts are passed to QRFM. XferDoor
will use the QRFM database to determine if a file is already on the
BBS. Existing files, includeing offline files can then be rejected.
XFERDR72.ARJ is the latest normal release at this time. It Supports
both QuickBBS Vers 2.75 and RA Vers 1.10/1.11. XferDr72.ARJ can be
downloaded from Mountain Retreat BBS at (408)335-4595 or Freq the
magic name XferDoor from 1:216/506. XferDoor requires the QRFM
environment variable be set. (SET QRFM=C:\QRFM), set it to whatever
directory QRFM is in.
5. CntDown
CntDown will read DnLoads.Log file and record the download count in
the QRFM Data Base. CntDown can be used only once on a DnLoads.Log.
If you run this more than once on the same DnLoads.Log your download
count would be doubled.
This utility was intended to used only once, with the program
QRFMFLst being used for maintaining download counts after CntDown
establishes a baseline.
This program wants to be run from your QRFM directory.
6. UpBy
UpBy reads the UpLoads.Log file and records the name of the user
that uploaded each file into the QRFM Data Base. As with CntDown,
this utility was intended to used only once,
to established a baseline.
Like CntDn this program must be run from the QRFM directory.
7. ReBldIdx
This utility can be used as part of a backup system, it makes
the backup of .IDX files un-necessary as they can be regenerated
with this utility.
8. VerifDb
VerifDb is required only in the event the QRFM data base and
directories/files become out of sync due to a hard disk crash,
additions/deletions of files outside of QRFM (a NoNo) or whatever.
See Recovery from a Hard Disk Crash above for info on it's use.
History:
Version 2 fixed a bug that caused problems in Index files when the
index file size reached 32k. A function was added to the OffLine_Ops
Menu, Mark Backup N/R. This function will mark files not requiring
backup, keeping them off of the NotBacked Up PickList. Reference
area lists are created in .ANS and .ASC format for use with Type 45
or Type 5 menu types.
Version 3.0 adds file taging for group moves and a jump to feature.
With the jump to feature, if a pick list of files is displayed pressing
a character will jump to the first file whos name starts with that
character. The utility VerifyDB.Exe was added, it was created mainly
for use in the event of Hard Disk problems.
Version 3.0a corrects a few minor glitches discovered after the 3.0
release.
Version 3.0b adds the File functions, Lower Description Case and
UpLoaded By Name Edit. It also corrects problems in the utilities
VerifDB and ReBldIdx. They were flawed and the files they created
did not totally match the actual condition of the BBS files.
Version 3.1 corrects a problem with a disappearing highlite bar in
the NotBacked Up Pick List. It also eliminates a bug that prevented
a download area's associated backup area from being changed to a new
non existing area. Made a change to the Load new Uploads function,
on compleation of this function the user is now presented with the
Upload Files Pick List. A Config menu option for selecting A or B
drives for floppy backups was added. Docs cleaned up a bit.
Version 3.1a corrects a glitch in the new backup drive selection
function. It also adds ReCompress and BackUp to the selections
on the status line. Corrected an alignment problem in the positioning
of extended description lines displayed by QRFMSrch and SrchDoor.
Version 3.1b corrects a problem that prevented QRFM from creating a
new config file. Also added message notifying user if memory at
startup is inadequate.
Version 3.2 SrchDoor will now work on Multinode systems. Also fixed
a problem with SrchDoor repeating a record when doing a word search
if that word was repeated in the record. QRFM and QRFMFLst will
obtain the uploaders name from the UpLoads log if XferDoor is not
providing the info. QRFMFLst will obtain download counts from the
DnLoads log if XferDoor isn't providing them.
Version 3.3 Beta. Support for CDROM directories added. A message
stateing that QRFM is working will now be displayed during time
consuming processes. Areas can now be imported 1 at a time (Config
Menu).
Version 3.4 minor changes to beta version.
Version 3.5 SrchDoor revised by adding HotKey feature and an
additional New Files menu item.
Version 3.6 Set 535k as minimum memory requirement.
Version 3.6a bugfix in QRFM and QRFMFLST Import Upload routines.
Version 3.7 When shelling to DOS or other programs, QRFM as of this
change will swap to EMS if available, if EMS is not available QRFM
will swap to disk.
Version 3.8 BugFix Fixed bug that caused hang at startup
Version 3.9 fixes 3 problems.
a. QRFM could not handle CD-ROMs that included a Files.BBS
in the CD-ROM directories. This revision fixes that CD-ROM problem.
b. QRFM could not handle the decompression and compression of files
that included subdirectory information. Changes in this revision
fix the decompression/compression problem.
c. The Import a Files.BBS function would not import just one
Files.BBS. QRFM will now import one Files.BBS at a time.
Version 4.0 cleans up problems introduced by Version 3.9. This fix
required that the comment field in the Compression Methods Dialog
be eliminated, the space was required for the addition of an
Alternate Extraction method.
Version 4.1 Added Srchdor2, it uses DorInfo1.Def instead of
ExitInfo.BBS as SrchDoor for systems not able to produce ExitInfo.BBS.
Disclaimer agreement
Users of QRFM and it's utilities must except the following disclaimer
agreement:
QRFM and it's utilities are provided AS IS. The Author makes no
Warranty of any kind, expressed or implied. In addition THE AUTHOR
ASSUMES NO LIABILITY FOR DAMAGES WHICH MAY RESULT WHICH MAY RESULT
FROM THE USE OF QRFM or it's utilities.
QRDB is ShareWare, a $15 registration fee is required. For an
additional $10 I'll send you a copy of the latest version with with
a 65 character message of your choice replacing the following line
in the QRFM SrchDoor menu.
╠════════════════════════════════════════════════════════════════════════╣
║ QRFM SrchDoor - Mt. Retreat Software - Support BBS (408)335-4595 ║
╚════════════════════════════════════════════════════════════════════════╝
If you decide to continue useing QRFM after a 90 day trial period
you are expected to register. Please send your registration fee to:
John Jamieson
Mountain Retreat Software
555 Buckeye St.
Felton Ca, 95018
For support contact:
Fidonet 1:216/506
Internet John.Jamieson@f506.n216.z1.FIDONET.ORG
BBS phone (408)335-4595
Voice (408)335-4672